home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / lanutsrc.zip / RXM.DOC < prev    next >
Text File  |  1991-03-13  |  4KB  |  130 lines
  1.          Resident Extension Module #1 (NRUN and NBOUNCE)
  2.                         Beta Documentation
  3.                         
  4.  Programs and documentation (C) Copyright 1990 by SoftMagic Inc.
  5.                        All rights reserved.
  6.                        
  7.                        
  8. The Resident Extension Modules (RXM), of which this is the first,
  9. are going to be a series of small TSR programs that add
  10. specialized capabilities to LANtastic.  To get the capabilities
  11. that you need, you load only the RXMs you want -- this keeps
  12. LANtastic small as it's intended to be, while still giving you the
  13. features that you want.
  14.  
  15. RXM #1 consists of an installable module and three functions,
  16. NRUN, which allows you to run DOS commands on remote workstations,
  17. NBOUNCE, which allows you to log remote stations off of a server,
  18. and NREBOOT, which allows you to reboot any remote station.
  19.  
  20.  
  21. To use the RXM functions, you must first load the resident module
  22. by typing 
  23.  
  24.     RXM
  25.     
  26. at the DOS prompt, or by including it in your AUTOEXEC.BAT file or
  27. STARTNET.BAT. This first RXM only occupies 880 bytes of RAM!
  28.  
  29. Once you've loaded RXM, you can use NRUN, NBOUNCE and NREBOOT from any
  30. station on the LAN. (of course, they will only affect stations on
  31. which you have run RXM. That's another benefit of the RXM
  32. philosophy -- you can set up different configurations as needed on
  33. different stations) 
  34.  
  35.                           How They Work
  36.  
  37. NRUN's syntax is
  38.  
  39.     NRUN <machineID> <command>
  40.     
  41.     
  42. NBOUNCE's syntax is
  43.  
  44.     NBOUNCE <machineID> <server>
  45.     
  46. NREBOOT's syntax is
  47.     
  48.     NREBOOT <machineID>    
  49.     
  50. In all cases, <machineID> is a standard REDIR node name, exactly
  51. as used by the NET SEND command.  The most important implication
  52. of this is that using '*' for the <machineID> means that the
  53. command or logout message gets sent to everyone.  You can run a
  54. command on *all* the stations on your network or log everyone out
  55. of a given server with a single command.
  56.  
  57.  
  58.                 Limitations and Potential Hazards
  59.  
  60. Let me stress that this is an EARLY BETA version of RXM #1 and is
  61. distributed only for the purpose of testing. While the code works
  62. as advertised, there are a few potential design and security
  63. "gotchas."  Use these utilities with great care.
  64.  
  65. For one thing, since the RXM uses LANtastic's unsolicited message
  66. facility to transmit its remote control messages, this version
  67. works best if you use the commands
  68.  
  69.     NET MESSAGE/DISABLE POP
  70.     NET MESSAGE/DISABLE BEEP
  71.  
  72. to disable the internal message handler's default behavior. In
  73. particular, strange things may result if you leave LANtastic's pop
  74. up message handler enabled. Possibly I'll cure this in the
  75. production version by using NetBIOS instead of the NOS to transfer
  76. messages, but for now the NOS makes things small and easy.
  77.  
  78. Also note that for now, you can't NBOUNCE (or NREBOOT) yourself
  79. off the machine you're using. In other words, if you're at server
  80. JON, and you issue an
  81.  
  82.     NBOUNCE * JON
  83.     
  84. you will log everybody off but yourself.  You will have to issue a
  85. normal NET LOGOUT JON for that.    
  86.  
  87. Security (and data integrity) is another potential concern. The
  88. current version of RXM has virtually no built in limitations --
  89. you can log off or reboot anyone on the network from any station.
  90. Further, RXM doesn't care if you're the owner of the company or a
  91. visiting third grader, it will still work. Consequently, it might
  92. be a good idea to hide NRUN, NBOUNCE and NREBOOT away in a
  93. subdirectory off the beaten path. (a small pun --- *very* small)
  94.  
  95. You should also be careful not to NBOUNCE or NREBOOT somebody
  96. who's in the middle of an application. The network tries to close
  97. files in an orderly way, but even an organized logout in the
  98. middle of an application has the same basic effect as rebooting
  99. the station out from under the network.
  100.                     
  101.                              Summary
  102.                              
  103. So, on that happy note, I'll leave you to testing.  Have fun and let
  104. me know if you find any problems or have any suggestions for improvement. 
  105. I can be reached through the Artisoft BBS or on BIX (jmarbry).
  106.  
  107. Thanks,
  108. Jon Marbry 
  109. SoftMagic, Inc.
  110. August, 1990                             
  111.                 
  112.      
  113.                                
  114.                                
  115.                                
  116.  
  117.     
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.